home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / pascal / bbskt30a.zip / README < prev    next >
Text File  |  1993-11-10  |  5KB  |  107 lines
  1.  
  2.         Welcome to BBSkit!  First, let me thank you for taking an interest in
  3. this package.  I feel that BBSkit is easily the best package of its kind for
  4. BBS and door applications.  (Yes, BBSkit can just as easily be used to write
  5. door programs!)
  6.  
  7. WHAT IS BBSKIT?
  8.  
  9.         BBSkit is just exactly what the name implies: it is a toolkit designed
  10. to help you, as a Pascal programmer, author a BBS.  Usually, a BBS author
  11. needs to be concerned with all kinds of dirty things like serial routines,
  12. time limits, ANSI terminal emulation, and the like.  BBSkit relieves you of
  13. this tedious burden by providing a very complete BBS template.  This template
  14. includes the various procedures and functions needed especially by a BBS
  15. author, such as:
  16.  
  17.         * Both an object and procedural calling method.  The object version
  18.           gives ideal support for a BBS, while the procedural calling method
  19.           is where most of the gritty low-level stuff is contained.  You
  20.           pick the method that works best for you!
  21.  
  22.         * Support for up to 8 simultaneously operating serial ports.
  23.  
  24.         * Low-level serial routines, written in 8088 assembler, to provide up
  25.           to 115,200 bits per second through any kind of National-based UART,
  26.           from the 8250B up to the FIFO buffered 16550A.  And since these
  27.           routines are in assembler, they're FAST!  No need for a FOSSIL or
  28.           other type of device driver, either!
  29.  
  30.         * BBSkit allows you complete control over where I/O goes: the console,
  31.           the serial port, the printer, a disk file, or any combination of
  32.           the four.
  33.  
  34.         * Pascal-like procedures to read and write strings of text, from
  35.           either the console or the serial port, or both at the same time!
  36.  
  37.         * A complete emulation system, allowing you to simply load a template
  38.           and have the complete control over any terminal you desire, from
  39.           simple VT-52 to full-color ANSI.  Now your BBS need only ask for
  40.           a code (for example, to change colors) and BBSkit will return the
  41.           proper string to perform this action, based on the template you have
  42.           loaded.
  43.  
  44.         * Support for the three most popular file transfer protocols,
  45.           including Xmodem (and derivatives), Ymodem and Ymodem-G.  Full
  46.           batching support is included for Ymodem.
  47.  
  48.         * DOS-like "TYPE" procedure, to send entire text files out the serial
  49.           port.
  50.  
  51.         * Optional paging: when a screen of text fills up without any user
  52.           input, BBSkit can be instructed to wait for the user to press a
  53.           key to continue.  This works with ALL of BBSkit's output procedures.
  54.  
  55.         * Mouse support over a serial connection!  Your programs can now
  56.           allow the remote user to use a mouse to make selections on your
  57.           system, with very little additional coding on your part.
  58.  
  59.         Don't let the toolkit intimidate you.  It may seem hulking and
  60. complicated, but once you get the hang of it, serial communications will never
  61. be easier.  The included BBSKIT.DOC file is a fairly complete excerpt of the
  62. registered version's printed documentation.  This .DOC file will explain all
  63. of the procedures and functions included in BBSkit, and you can use it as a
  64. base for experimenting on your own.
  65.  
  66. INSTALLING THE TOOLKIT
  67.  
  68.         Probably the easiest way of installing the kit is to place it in your
  69. units directory, or a directory in your units path.  Optionally, you can place
  70. the files in your source directory.
  71.  
  72.         If you plan the use the toolkit in real-mode programming (TP6 or BP7
  73. in real mode target), you will need to rename some files.  TP6 users need to
  74. rename the *.TP6 files to *.TPU, and BP7 users will need to rename the *.TP7
  75. files to *.TPU.  Example:  REN *.TP7 *.TPU
  76.  
  77.         Additionally, you will need to unzip the MTASK archive contained here.
  78. MTASK is a public domain unit that provides multithreading in Turbo Pascal
  79. programs and is used by BBSkit 3.0.  You can use any type of unzipper,
  80. including the one provided for TP6+ installations, to unarchive this file.
  81. PLEASE NOTE THAT MTASK WAS NOT WRITTEN BY BBSKIT'S AUTHOR!  I don't claim any
  82. credit for writing it; I just think it's a great unit and really useful.
  83.  
  84. COMMENTS OR QUESTIONS?
  85.  
  86.         If you have any comments or questions regarding BBSkit, I would love
  87. to hear from you!  You can reach me in several ways:
  88.  
  89. Home address: 1888 Edith Marie Drive
  90.               Beavercreek, OH  45431-3377
  91.               USA
  92.  
  93. CompuServe:   >INTERNET:sjmadsen@miavx1.acs.muohio.edu
  94. Internet:     sjmadsen@miavx1.acs.muohio.edu
  95. BITNET:       SJMADSEN@MIAVX1
  96.  
  97.         The latest version of BBSkit is always available on the Internet and
  98. is available for anonymous ftp at any time.  ftp to ftp.cas.muohio.edu and
  99. look in the directory /pub/dos/bbskit.  There are also some examples here as
  100. well as information which may be of interest to BBSkit users.  See the manual
  101. for more information on the ftp site and the mailing list which has been
  102. started for BBSkit users.
  103.  
  104.  
  105.         Thanks again, and enjoy BBSkit!
  106.  
  107.